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( BEGIN ) 
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FIG. 5 



CALL BACKUP 
TABLE FILE 



SELECT FILESYSTEMS 
TO BACKUP 



-516 



-518 



SPLIT MIRRORED 
FILESYSTEMS 



520 



FIG. 9G 



fi 



| Table file format 

| Format: bc:pfs:plv:c:afs:alv 

I xb:/home:hd1 :2/alt/home:/altlvh 



exec 3<&- 



I 
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fscpbtab_unlock.ksh 

Version 0.01 

Runs various AIX commands to remove lock on 

the FSCPBK table file 
Assembled by Carl Gusler 

IBM Global Services 

IBM Austin 

cgusler@us.ibm.com 

(With help from many friends) . 

Copyright IBM 1996, 1997, 1998, 1999 
Controlled Distribution 

Protected under the procedures, processes, rights 
rules, regulations, and retributions of 
IBM Global Services 
Intellectual Capital Management 



Copyright Information: Copyright IBM 1998 
Controlled Distribution 

Protected under the procedures, processes, rights 
rules, and regulations of 
IBM Global Services 
Intellectual Property Management 

This program is an IBM Type II Deliverable as 
described in the IBM Customer Agreement and 
relevant IBM services contracts. 

IBM retains all rights to this program and does not 
transfer any rights for replication or distribution 
of this program except for the following: 

1. Backup/archive copies taken as a normal 
course of system maintenance. 

2. Copying the program to a similar machine 
within the same enterprise. 

The customer agrees to restrict access to this 
program as they would their own proprietary code, 

and to notify IBM should unauthorized distribution FIG *7 A. 
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This program is distributed on an "as is" basis, 
no warranty is expressed or implied. 



Description: Removes lock on /etc/fscpbktab table file. 

A cleanup utility for problem times with FSCPBK scripts 
Operational Environment: AIX V4 
Input: 
Output: 
Return Value: 

Comments: NOTE!!: This script is an excerpt of the fscpbk.back.ksh 
script. If that script is edited, this one 
should probably be edited to match. 



| Version History: None 

# 

# Environmental Variables 



Constants 

bar='==================================================: 

wire='= ' 

§ Variables 

numeric_date=$(date +%m%d 
texLdate=$(date +%d%b%Y) 
typeset -i return_code %y) 
typeset -i merge_return_code 
typeset -i retain_days=90 

typeset -i in_retain_days TPTH '£? 

typeset -i copies F ILr. f JD 

typeset -i ncrement 
typeset -i mounLfs_test 
invoked_name=$0 

scripLname=${invoked_name##*/i 

user_id=$(whoami) 

desc='ADSM Archive at'$texLdate 

level=0 
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| Process Control Variables 7/51 
Lflag=0 

L-flag=0 tpth n/n 

r_flag=0 rlLr. (L 

d_flag=0 

| Files 

defaulLlog_dir=/var/adm/scriptlogs 

defaulLlog_file=$scripLname.$texLdate 

defaulLbackup_device=/dev/rmtO. 1 

worlefile1=/tmp/$scripLname.$texLdate.work1 

work_file2=/tmp/$scripLname.$texLdate.work2 

config_file=/etc/fscpbktab 

audiLfile=/etc/fscpbktab.audit 

lock_file=/var/locks/fscpbktab 



Function: show_usage 

Description: Displays command usage syntax and exits 
Input: None 

Output: Usage message to standard error 
Return Value: 2 

Note: This function does not return. It completely exits. 



show_usage () 

i 



pn 
pri 
pri 
pri 
pri 
pri 
pri 
pri 
pri 
ex 



-u2" 

-u2 "Usage: fscpbktab_unlock.ksh [-I directory] [-r days] " 
-u2 

-u2 " -I directory Log output directory." 
-u2 " Default is" $defaulLlog_dir 

- U 2 " 

-u2 " -r days Log retention period." 
-u2 " Default is" $retain_days 

-u2 " " 



Korn Shell Settings 



set -o errexit § Turn on error trapping and error exit mode 

set -o noclobber # Prevent overwriting of existing files 

set -o noexec § Perform syntax checking without execution 

set -o nolog § Prevents storing function defs in history file 
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jjfset -o xtrace § Turn on debug mode T 1 Lr. 

i 

§ Main Routine 

i 

i 

i 

# Test for any passed parameters. 
|if [ $? !- 0 ] 

fthen 

| show_usage 
# 

log„dir=$defaulLlog_dir 

# Parse Command Line Arguments into Variables 
while getopts l:rjjf c 

do 

case $c in 

I) # Set up the -I flag 
Lflag=1 

log_dir=$OPTARG;; 
r) § Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_usage;; 
esac 
done 

shift $((0PTIND-1)) 

§ Deal with invocation errors 
if [[ $user_id != root ]]; then 
show_usage 

fi 



§ Configure Logging 

if [[ $Lflag -eq 1 ]]; then 

log_file=$in_log„dir/$defaulLlog_file 

mkdir -p $in_log_dir 2>/dev/null #Create new log directory 

else 

log_file=$defaulLlog_dir/$defaulLlog_file 

mkdir -p $defaulLlog_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_days=$in_retain_days 
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§ Clear old logs 

find $log_dir -name "$scripLname*" -mtime $retain_days -exec rm |}\; 
§ Create new log file 

exec 3>> Slog file § Open log file for writing 



\n= 



= Systems Management Transaction Log 

= Created by script:" $scripLname 
= on system:" $(hostname) 
at :" $(date) 



print -u3 

print -u3 

print -u3 

print -u3 

print -u3 

print -u3 

print -u3 

print -u3 

print -u3 



# Perform Work 

| Comments: NOTE!!: This script is an excerpt of the fscpbk_back.ksh 

§ script. If that script is edited, this one 

§ should probably be edited to match. 

# 

§ Test for existing table file 
if [[ ! (-r $config_file) ]]; then 

print -u2 "Fatal Table error. Table file" $config_file "not found." 

print -u3 "Fatal Table error. Table file" $config_file "not found." 

exec 3<&- 

exit 99 

fi 

§ Unlock table file 

chmod 644 $config_file 
rm $lock_file 2» $log_file 



exec 3<&- 



exit 0 



FIG. 7E 
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§ fscpbktab_build.ksh 

| Version 0.33 

| Runs various AIX commands to build 

| table of filesystems to backup 

| Assembled by Carl Gusler 

§ IBM Global Services 

§ IBM Austin 

jjf cgusler§us.ibm.com 

# 

jjf (With help from many friends) 
# 

# Copyright IBM 1996, 1997, 1998, 1999 
jjf Controlled Distribution 

| Protected under the procedures, processes, rights 

jjf rules, regulations, and retributions of 

# IBM Global Services 

| Intellectual Capital Management 

f 

§ 



| 

§ Copyright Information: Copyright IBM 1998 

| Controlled Distribution 

jjf Protected under the procedures, processes, rights 

| rules, and regulations of 

1 IBM Global Services 

| Intellectual Property Management 

i 

jjf This program is an IBM Type II Deliverable as 

jjf described in the IBM Customer Agreement and 

| relevant IBM services contracts. 

i 

jjf IBM retains all rights to this program and does not 

| transfer any rights for replication or distribution 

I of this program except for the following: 

jjf 1. Backup/archive copies taken as a normal 

jjf course of system maintenance. 

jjf 2. Copying the program to a similar machine 

| within the same enterprise. 

i 

jjf The customer agrees to restrict access to this 

| program as they would their own proprietary code, 

jjf and to notify IBM should unauthorized distribution 

I occur. FIG. 

I 
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This program is distributed on an "as is" basis, 
no warranty is expressed or implied. 



Description: Builds table file for other scripts in FSCPBK package. 

Operational Environment: AIX V4 and ADSM V3.1 

Input: 

Output: 

Return Value: 

Comments: 



# 

Version History: None 



Environmental Variables 



Constants 

bar='===================== 

wire='= 

§ Variables 

numeric_date=$(date ^m%d%H%M) 
texLdate=$(date +%d%b%Y) 



return_code 
retain_days=10 
in_retain_days 
copies 
ncrement 



typeset -i 
typeset -i 
typeset -i 
typeset -i 
typeset -i 

typeset -i return_code TPjn QT) 

invoked_name=$0 r ILr. (DID 

scripLname=$| invoked_name#j|f*\} 
user_id=$(whoami) 



§ Process Control Variables 

Lflag=0 

Ulag=0 

r_flag=0 
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§ Files 12/51 

defaulUog_dir=/var/adm/scriptlogs FIG. 8 C 

defaulUog_file=$scripLname.$texLdate 

work_file1=/tmp/$scripLname.$texLdate.work1 

work-file2=/tmp/$scripLname.$texLdate.work2 

conf ig_f ile=/ etc/fscpbktab 

lock_file=/var/locks/fscpbktab 



i 

§ Function: show_usage 

§ Description: Displays command usage syntax and exits 

§ Input: None 

§ Output: Usage message to standard error 

# Return Value: 2 

§ Note: This function does not return. It completely exits. 

i 

i 

show_usage () 

i 

print -u2 " 

print -u2 "Usage: fscpbktab_build.ksh [-1 directory] [-r days] " 

print -u2 " 

print -u2 " -I directory Log output directory." 

print -u2 " Default is" $defaulUog_dir 

print -u2 " 

print -u2 " -r days Log retention period." 

print -u2 " Default is" $retain_days 



print -u2 
exit 2 



§ Korn Shell Settings 

i 

#set -o errexit § Turn on error trapping and error exit mode 

#set -p noclobber § Prevent overwriting of existing files 

#set -o noexec § Perform syntax checking without execution 

#set -o nolog § Prevents storing function defs in history file 

#set -o xtrace § Turn on debug mode 



§ 

§ 

§ Main Routine 
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\ t ♦ , h ♦ FIG. 8D 

§ Test for any passed parameters. 

#if [ $? != 0 ] 

#then 

§ show_usage 
ffi 

log_dir=$defaulUog_dir 

§ Parse Command Line Arguments into Variables 

while getopts a:l:p:r# c 

do 

case $c in 

I) § Set up the -I flag 
Lflag=1 

log_dir=$0PTARG;; 
r) § Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_usage;; 
esac 
done 

shift $((0PTIND-1)) 

§ Deal with invocation errors 
if [[ $user_id != root ]]; then 
show_usage 

fi 



§ Configure Logging 

if [[ $Lflag -eq 1 ]]; then 

log_file=$inJog_dir/$defaulUog_file 

mkdir -p $inJog_dir 2>/dev/null #Create new log directory 

else 

log_file=$defaulLlog_dir/$defaulLlog_file 

mkdir -p $default_log_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_days=$in_retain_days 

fi 

# Clear old logs 

find $log_dir -name "$scripLname* M -mtime $retain_days -exec rm |}\; 

# Create new log file 

exec 3» $log_file # Open log file for writing 
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print -u3 "\n========================= 

print -u3 M = =" 

print -u3 "= Systems Management Transaction Log 

print -u3 "= =" 

print -u3 "= Created by script:" $scripLname 

print -u3 "= on system:" $(hostname) 

print -u3 "= at :" $(date) 

print -u3 "= 

print -u3 "==========================: 



§ Perform Work 

§ Test for locked table file and exit 
if [[ -f SlockJile ]]; then 

print -u2 "Table file is currently in use and locked." 

print -u3 "Table file is currently in use and locked." 

exec 3<&- 

exit 96 

fi 

§ Test for existing table file and save 
if [[ -r $config_file ]]; then 

mv $config_file $config_file.old.$text_date 

fi 



-u4 -f=========««=«======««======««=======««=- 

-u4 "# Filesystem Backup Selection Table file =" 

-u4 ;# 

-u4 "§ Format: bc:pfs:plv:c:afs:alv 

-u4 "§ or =" 
-u4 "| 

-u4 "# be (Backup Control) 

-u4 "| xb -> AIX Backup (Level 0 AIX FS Backup) =" 

-u4 "| no -> NO Backup (Skip filesystem) 

-u4 "| as -> ADSM Selective Backup 

-u4 "| ai -> ADSM Incremental Backup =" 

-u4 "I aa -> ADSM Archive =" 

-u4 "# 

-u4 ;# 

-u4 n § pfs (Primary Filesystem) =" 

-u4 n § The full path of standard filesystem =" 

_u4 !! # = " FIG 8E 

-u4 "§ plv (Primary Logical Volume) =" 
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print -u4 "# The AIX LV name of the logical volume 

print -u4 "§ containing the primary filesystem =" 

print -u4 "# =" 

print -u4 "# c (Copies) 

print • — u4 "| The number of AIX LVM copies of the =" 

print -u4 "| logical volume containing primary 

print -u4 "§ filesystem. =" 

print -u4 "# Must be numeric 1,2, or 3. =" 

print -u4 "jjf =" 

print -u4 "| afs (Alternate Filesystem) =" 

print -u4 "| The full path of mirror copy filesystem =" 

print -u4 "| Must be unique!!!!! =" 

print -u4 "# 

print -u4 "| alv (Alternate Logical Volume) =" 

print -u4 "| The AIX LV name of the logical volume 

print -u4 "| containing the alternate filesystem =" 

print -u4 "| Must be unique!!!!! =" 

print -u4 "| =" 

print -u4 "| Example for a mirrored home filesystem to be =" 

print -u4 w | backed up using AIX backup command: = 

print -u4 "§ = 

print -u4 "# xb:/home:hd1:2:/alt/home:altlvh =" 

print -u4 "| =" 

print -u4 "|============================================= 

print -u3 "\nStarting Build of Filesystem Backup Table File" 

print -u3 "\nTable lines are:" 

ncrement=0 

return_code=0 

for fsjine in $(lsfs -ac | grep -v -#) 
do 

if [[ $(print $fs_line | cut -f 3 -d : ) = jfs ]]; then 
fs_prime=$(print $fs_line | cut -f 1 -d :) 
Iv_prime=$(print $fs_line | cut — f 2 — d : | cut -c 6-) 

| What if LV in /etc/filesystems does not actually exist? 
| LSLV below croaks 

copies=$(lslv $lv_prime | grep COPIES | awk '| print $2 j') 
if [[ $copies -eq 1 ]]; then 

tab_line=xb:$fs_prime:$lv_prime:$copies 
elif [[ $copies -eq 2 ]]; then 

tab_line=xb:$fs_prime:$lv_prime:$copies:/alt/fs$ncrement:altlv$ncrement 

((ncrement=$ncrement+ 1 )) 
elif [[ fcopies -eq 3 ]]; then 

tab_line=xb:$fs_prime:$lv„prime:$copies:/alt/fs$ncrement:altlv$ncrement 



else 



((ncrement=$ncrement+ 1 )) J* 1 JO* 
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tabjine=xb:$fs_prime:$lv_prime:1 

print -u2 Script execution error: AIX Islv output confusion" FIG. 8G 
print -u3 "Script execution error: AIX Islv output confusion" 
((return_code=$return_code+1 )) 

fi 

print -u3 $tab_line 
print -u4 $tabjine 
fi 

done 



exec 3<&- 
exec 4<&- 



§ Test for filesystem parsing problems 
if [[ $return_code -ne 0 ]]; then 
exit 10 

fi 



exit 0 

FIG. 12J 

X else 

print -u3 "Filesystem" $targeLfs "not mountable. Not backed 
return_code=1 

fi 

fi 

done 



exec 3<&- 



# Test for unsuccessful filesystem merges 
if [[ $merge_return_code -ne 0 ]]; then 
exit 20 

fi 



rm $lockJile 2>/dev/null 
chmod 644 $config_file 

§ Test for unsuccessful filesystem backups 
if [[ $return_code -ne 0 ]]; then 
exit 10 

fi 



exit 0 
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mii§§§§§§§§§§§§m§§i§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§#§§§§§§§§§ 

# fscpbktab_check.ksh 

I Version 0.33 

I Runs various AIX commands to check filesystem 

# table file 

# Assembled by Carl Gusler 

# IBM Global Services 

# IBM Austin 

| cgusler@us.ibm.com 

§ 

§ (With help from many friends) 

i Copyright IBM 1996, 1997, 1998, 1999 
Controlled Distribution 
Protected under the procedures, processes, rights 
rules, regulations, and retributions of 
IBM Global Services 
Intellectual Capital Management 

§ 

mmimmimmmimmmmimiiiMiiiiiiiiiiiimiiiiiiiiim 
i 

i Copyright Information: Copyright IBM 1998 
Controlled Distribution 
Protected under the procedures, processes, rights 
rules, and regulations of 
IBM Global Services 
Intellectual Property Management 

I This program is an IBM Type II Deliverable as 

# described in the IBM Customer Agreement and 
| relevant IBM services contracts. 

# IBM retains all rights to this program and does not 

# transfer any rights for replication or distribution 

# of this program except for the following: 

# 1. Backup/archive copies taken as a normal 
| course of system maintenance. 

I 2. Copying the program to a similar machine 

| within the same enterprise. 

!The customer agrees to restrict access to this 
program as they would their own proprietary code, 
and to notify IBM should unauthorized distribution 
FIG. 9A 
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mi FIG 

This program is distributed on an as is" basis, 
no warranty is expressed or implied. 



Description: Performs syntax check on FSCPBK table file. 

Part of FSCPBK package of scripts. 
Operational Environment: AIX V4 and ADSM V3.1 
Input: 
Output: 
Return Value: 
Comments: 



§ Version History: None 



# Environmental Variables 



§ Constants 

bar='===================: 

wire='= 

§ Variables 

numeric_date=$(date +%m%d%y) 
texLdate=$(date +%d%b%Y) 
typeset -i return_code 
typeset -i retain_days=90 
typeset -i in_retain_days 
typeset -i copies 
typeset -i lv_copies 
typeset -i lv_disks 
typeset -i ncrement 
typeset -i return_code 
invoked_name=$0 

scripLname=${invoked_name#)if*/| 
user_id=$(whoami) 
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§ Process Control Variables 19/51 TP TP QT 

Lflag=0 riLr. C7 O 

Ulag=0 
r_Jlag=0 

£ Rles 

defaulUog_dir=/var/adm/scriptlogs 

defaultJog_file=$script_name.$texLdate 

work_file1=/tmp/$scripLname.$texLdate.work1 

work_file2=/tmp/$scripLname.$texLdate.work2 

config_file=/etc/fscpbktab 

audiLfile=/etc/fscpbktab.audit 

lock_file=/var/locks/fscpbktab 



# Function: show_usage 

§ Description: Displays command usage syntax and exits 
§ Input: None 

| Output: Usage message to standard error 
| Return Value: 2 

| Note: This function does not return. It completely exits. 

i 

i 

show_usage () 

\ 

print -u2 " 

print -u2 "Usage: fscpbktab_check.ksh [-I directory] [-r days]" 

print -u2 w 

print -u2 " -I directory Log output directory." 

print -u2 " Default is" $defaulUog_dir 

print -u2 " 

print -u2 " -r days Log retention period." 

print -u2 " Default is" $retain_days 

print -u2 " 
exit 2 



Korn Shell Settings 



jjfset -o errexit j|f Turn on error trapping and error exit mode 

|set -o noclobber § Prevent overwriting of existing files 

|set -o noexec § Perform syntax checking without execution 

|set -o nolog § Prevents storing function defs in history file 

|set -o xtrace § Turn on debug mode 
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, 2 lll FIG. 

I 

| Main Routine 

i 

i 

i 

§ Test for any passed parameters. 

#if [ $? != 0 ] 

#then 

I show_usoge 
I 

log_dir=$defaulUog_dir 

§ Parse Command Line Arguments into Variables 

while getopts a:l:p:r# c 

do 

case $c in 

I) | Set up the -I flag 
l_flag=1 

log_dir=$0PTARG;; 
r) § Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show.usage;; 
esac 
done 

shift $((0PTIND-1)) 

§ Deal with invocation errors 

# Configure Logging 

if [[ $Lflag -eq 1 ]]; then 

log_file=$in_log_dir/$defaulLlog_file 

mkdir -p $inJog_dir 2>/dev/null #Create new log directory 

else 

log_file=$defaulLlog_dir/$defaulLlogfile 

mkdir -p $defaulUog_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_days=$in_retain_days 

fi 

| Clear old logs 

find $log_dir -name w $scripLname* M -mtime $retain_days -exec rm |}\; 
| Create new log file 

exec 3» $log_file § Open log file for writing 
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pnrv 
prin^ 
pm 
prin 
prirv 
prin 
prin 
prin ( 
prin 
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-u3 "\n==— ====================== 

-u3 = = 
-u3 w = Systems Management Transaction Log 

-t ft n 

-u3 " = Created by script:" $scripLname 
-u3 " = on system:" $(hostname) 
-u3 "= at :" $(date) 
-u3 " = 

- U 3 =========================== 



§ Perform Work 

| Test for existing table file 

if [[ ! (-r $config_file) ]]; then 

print -u2 "Table error: Table file" $config_file "does not exist" 
print -u3 "Table error: Table file" $config_file "does not exist" 
exit 99 

fi 

§ Test for locked table file 
if [[ -f llockJile ]]; then 

print -u2 "Warning: Table file is currently in use and locked" 

print -u3 "Warning: Table file is currently in use and locked " 

fi 

| Perform Syntax Checking on Table File 

return_code=0 

ncrement=1 

for fsjine in $(cat $config_file | grep -v ~#) 
do 

action=$(print $fs_line | cut -f 1 -d :) 
case faction in 

xb) : ;; 

no} : ;; 

as) : ;; 

ai) : ;; 

aa) : ;; 

*) print -u2 "Table error: Action" faction "not valid." 
print -u3 "Table error: Action" faction "not valid" 
((return_code=$return_code+ 1 ));; 

esac 

fs_prime=$(print ffsjine | cut -f 2 -d :) 

lv_prime=$(print ffsjine | cut -f 3 -d :) 

if [[ $(lsfs -c $fs_prime | grep $lv_prime | wc -I) -ne 1 ]]; then 

print -u2 "Table error: Filesystem" $fs_prime "does not reside in LV $lv_prime 
print -u3 "Table error: Filesystem" $fs_prime "does not reside in LV $lv_prime 
((return_code=$retum_code+ 1 )) 

fi FIG. 9E 

copies=$(print $fs_line | cut -f 4 -d :) 
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if [[ ($copies -ge 1) && ($copies -le 3) ]]; then Tpm O TP 

if [[ ($copies -gt 1) && ($copies -le 3) ]]; then r lLr. or 

fs_alt=$(print $fsjine | cut -f 5 -d :) 
lv_alt=$(print $fs_line | cut -f 6 -d ;) 
if [[ $(lsfs -c $fs_alt 2>/dev/null | wc -I) -ne 0 ]]; then 
print -u2 "Table error: Filesystem" $fs_alt " already exists." 
print -u3 "Table error: Filesystem" $fs_alt "already exists." 
((return_code=$return_code+1 )) 

fi 

if [[ $(lslv $lv_alt 2>/dev/null | wc -I) -ne 0 ]]; then 
print -u2 "Table error: LV" $lv_alt "already exists." 
print -u3 "Table error: LV" $lv_alt "already exists" 
((return_code=$return_code+ 1 )) 

fi 

strictness_flag=$(lslv $lv_prime | grep "EACH LP COPY ON" | grep yes | wc -I) 

if [[ $strictness_flag -eq 0 ]]; then 

print -u2 "LVM Warning: Mirror strictness not set for LV" $lv_prime 
print -u3 "LVM Warning: Mirror strictness not set for LV" $lv_prime 

fi 

lv_copies=$(lslv $lv_prime | grep COPIES | awk'j print $2 }') 

if [[ $lv_copies -ne $copies ]]; then 

print -u2 "LVM Warning: LV mirroring does not match table for LV" $lv_prime 
print -u3 "LVM Warning: LV mirroring does not match table for LV" $lv_prime 

fi 

lv_disks=$(lslv -I $lv_prime | grep hdisk | wc -I) 

if [[ $lv_disks -ne $lv_copies ]]; then 

print -u2 "LVM Warning: Broad LV mirroring distribution for LV" $lv_prime 
print -u3 "LVM Warning: Broad LV mirroring distribution for LV" $lv_prime 

fi 

fi 

else 

print -u2 "Table error: Invalid number of LV copies for LV" $lv_prime 
print -u3 "Table error: Invalid number of LV copies for LV" $lv_prime 
((return_code=$return_code+ 1 )) 

fi 

done 

if [[ ($return_code -ne 0) ]];then 
return 98 
else 

print -u2 "Table file parses okay" 

exec 4> faudiLfile § Open audit file for writing 

currenLY=$(date +%Y) 

currenLm =$(date +%m) 

currenLd=$(date +%d) 

currenLH =$(date +%H) 

currenLM=$(date +%M) 

§ print -u4 $currenLY $currenLm $currenLd $currenLH $currenLM 
print -u4 $currenLY$currenLm$currenLd$currenLH$currenLM 
exec 4<&- 
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fscpb_sync.ksh 

Version 0.02 

Runs various AIX commands to synchronize all 

stale logical volumes 
Assembled by Carl Gusler 
IBM Global Services 
IBM Austin 
cgusler@us.ibm.com 

(With help from many friends) 

Copyright IBM 1996, 1997, 1998, 1999 
Controlled Distribution 

Protected under the procedures, processes, rights 
rules, regulations, and retributions of 
IBM Global Services 
Intellectual Capital Management 



§ Copyright Information: Copyright IBM 1998 

I Controlled Distribution 

| Protected under the procedures, processes, rights 

I rules, and regulations of 

| IBM Global Services 

| Intellectual Property Management 

§ 

§ This program is an IBM Type II Deliverable as 

# described in the IBM Customer Agreement and 

| relevant IBM services contracts. 

§ 

§ IBM retains all rights to this program and does not 

| transfer any rights for replication or distribution 

§ of this program except for the following: 

I 1. Backup/archive copies taken as a normal 

| course of system maintenance. 

| 2. Copying the program to a similar machine 

| within the same enterprise. 



The customer agrees to restrict access to this 

program as they would their own proprietary code, JPT r* i H A 

and to notify IBM should unauthorized distribution r ILr. I UJ\ 
occur. 
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§ This program is distributed on an "as is" basis, 

| no warranty is expressed or implied. 

I 

| 

| 

I 

§ Description: Synchronizes all logical volumes with stale partitions 

§ Part of FSCPBK package. 

§ Operational Environment: AIX V4 

| Input: 

| Output: 

§ Return Value: 

| Comments: 

i 
§ 

i 

i 

i 

| Version History: None 

i 

i 

i 

i 

§ Environmental Variables 

i 

i 

§ Constants 

bar= ======================================== 

i 

wire= ,= * 



jjf Variables 

numeric_date=$(date +%m%d%y) 
texLdate=$(date +%d%b%Y) 
typeset -i return_code 

typeset -i retain_days=90 TP TP 1 (1 

typeset -i in_retain_days r ILr. I UJD 

typeset -i copies 

typeset -i ncrement 

typeset -i return_code 

invoked_name=$0 

scripLname=$|invoked_name##*/i 
user_id=$(whoami) 



§ Process Control Variables 

l_flag=0 

Lflag=0 

r_flag=0 

| Files 
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FIG. 10C 



defaulUog_dir=/var/adm/scriptlogs 
defaulUog_file=$scripLname.$texLdate 
work_file1=/tmp/$scripLname.$texLdate.work1 
worl^file2=/tmp/$scripLname.$texLdate.work2 
conf ig_f ile= /etc/f scpbktab 

# 

Function: show_usage 

Description: Displays command usage syntax and exits 
Input: None 

Output: Usage message to standard error 
Return Value: 2 

Note: This function does not return. It completely exits. 



show_usage () 

i 



prin 
prin 
prin 
prin 
prin 
prin 
prin 
prin 
prin 
exit 2 



-u2 



u2 "Usage: fscpbk_.sync.ksh [-I directory] [-r days] " 
u2 

-I directory Log output directory" 
Default is $defaulUog_dir 



•u2 
•u2 
•u2 
-u2 
-u2 
-u2 



-r days Log retention period." 
Default is" $retain_days 



Korn Shell Shell Settings 



set -o errexit #Turn on error trapping and error exit mode 

set -o noclobber § Prevent overwriting of existing files 

Ifset -o noexec § Perform syntax checking without execution 

set -o nolog | Prevents storing function defs in history file 

set -o xtrace f Turn on debug mode 



f 

i 
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I 

I 

§ Test for any passed parameters. 

#if [ $? != 0 ] 

#then 

§ show_usage 
log_dir=$defaulLlog_dir 

§ Parse Command Line Arguments into Variables 

while getopts l:r# c 

do 

case $c in 

I) # Set up the -I flag 
Lflag=1 

log_dir=$OPTARG;; 
r) § Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show„usage;; 
\?) show_usage;; 
esac 
done 

shift $((0PTIND-1)) 

| Deal with invocation errors 
if [[ $user_id != root ]]; then 
show_usage 

fi 



§ Configure Logging 

if [[ $Lflag -eq 1 ]]; then 

log_file=$in„log_dir/$defaulLlog_file 

mkdir -p $in_log_dir 2>/dev/null #Create new log directory 

else 

log_file=$defaulLlog_dir/$defaulLlog_file 

mkdir -p $defaulLlog_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_days=$in_retain_days 

fi 

§ Clear old logs 

find $log_dir -name "$scripLname* M -mtime $retain_days -exec rm ||\; 
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§ Create new log file 

exec 3» Slog file § Open log file for writing 

print -u3 "\n======================================== 

print -u3 = = 

print -u3 "= Systems Management Transaction Log =" 

print -u3 = = 

print -u3 "= Created by script:" $scripLname 

print -u3 "= on system:" $(hostname) 

print -u3 "= at :" $(date) 

print -u3 = = 

print -u3 "=========================================: 

§ Perform Work 

§ Test for any stale logical volumes within active volume groups 

print -u1 "Starting syncvg operation. This make take several minutes" 
return_code=0 

for logicaLvolume in $(lsvg -o | Isvg -il | grep stale | awk'j print $1 }') 
do 

print -u3 " Starting syncvg operation on LV" $logicaLvolume 
print -u1 "Starting syncvg operation on LV" $logical_volume 
syncvg -I $logical_ volume 
((return_code=$return_code+$?)) 

print -u3 " Completed syncvg operation on LV" $logical_volume 
print -u3 " Cumulated return code is" $return_code 
done 

exec 3<&- 

if [[ ($return_code -ne 0) ]];then 
return 50 

fi 

exit 0 



FIG. 10E 
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fscpb__select.ksh 

Version 0.34 



Runs various AIX commands to select and split 

filesystems for backup 
Assembled by Carl Gusler 

IBM Global Services 

IBM Austin 

cgusler@us.ibm.com 

(With help from many friends) 

Copyright IBM 1996, 1997, 1998, 1999 
Controlled Distribution 

Protected under the procedures, processes, rights 
rules, regulations, and retributions of 
IBM Global Services 
Intellectual Capital Management 



Copyright Information: Copyright IBM 1998 
Controlled Distribution 

Protected under the procedures, processes, rights 
rules, and regulations of 
IBM Global Services 
Intellectual Property Management 

This program is an IBM Type II Deliverable as 
described in the IBM Customer Agreement and 
relevant IBM services contracts. 

IBM retains all rights to this program and does not 
transfer any rights for replication or distribution 
of this program except for the following: 

1. Backup/archive copies taken as a normal 
course of system maintenance. 

2. Copying the program to a similar machine 
within the same enterprise. 

f 

The customer agrees to restrict access to this 
j! program as they would their own proprietary code, 

( and to notify IBM should unauthorized distribution „ _ 

I occur. FIG. 11 A 
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This program is distributed on an "as is" basis, 
no warranty is expressed or implied. 



§ Description: Selects and splits filesystems for backup. 

jjf Part of FSCPBK package of scripts. 

jjf Operational Environment: AIX V4 

jjf Input: 

§ Output: 

jjf Return Value: 

jjf Comments: 



jjf Version History: None 

# 

i 

i 

§ Environmental Variables 

# 

i 

§ Constants 

bar='================== 

wire='= 

j|f Variables 

numeric_date=$(date +%m%d%y) 
texLdate=$(date +%d%b%Y) 



typeset -i 
typeset -i 
typeset -i 
typeset - 
typeset -i 
typeset -i 
typeset -i 
typeset -i 
jjftypeset - 
jjftypeset - 
jjftypeset - 
|typeset - 



returrucode 

retain_days=90 

in_retain_days 

copies 

new_copies 

ncrement 

ntest 

return_code 
ediLyear 
ediLmonth 
ediLday 
ediLhour 



FIG. 11 B 
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^typeset -i ediLminute 
typeset -i ediLstamp 
typeset -i audiLyear 
typeset -i audiLmonth 
typeset -i audiLday 
typeset -i audiLhour 
typeset -i audiLminute 
typeset -i audiLstamp 
invoked_name=$0 
scripLname=$|invoked_namejjf#*/i 



jjf Process Control Variables 

Lflag=0 

Ulag=0 

r_flag=0 

o_flag=0 

# Files 

defaulLlog_dir=/var/adm/scriptlogs 

defaulLlog_file=$scripLname.$texLdate 

work_file1=/tmp/$scripLname.$texLdate.work1 

work_file2=/tmp/$scripLname.$texLdate.work2 

config_file=/etc/fscpbktab 

audit_fite=/etc/fscpbktab.audit 

lock_file=/var/locks/fscpbktab 



print -u2 " 

print -u2 "Usage: fscpbk_select.ksh -o [-I directory] [-r days] 
print -u2 " 



user_id=$(whoami) 



FIG. 1 




print -u2 " 

print -u2 " 

print -u2 " 

print -u2 " 

print -u2 " 



-o 



WARNING!!: Data integrity risk." 
IBM not responsible for" 
loss of data or integrity" 
if override used to split" 



Override active volume protection." 
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L/l II 11 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


print 


-u2 


exit 2 



31/51 

a mirrored filesystem" 
that is mounted!" 

-I directory Log output directory" 

Default is" $defaulUog_dir 

» 

-r days Log retention period " 
Default is" $retain_days 



Korn Shell Settings 



fset -o errexit § Turn on error trapping and error exit mode 

pet -o noclobber § Prevent overwriting of existing files 

pset -o noexec | Perform syntax checking without execution 

het -o nolog | Prevents storing function defs in history file 

jfset -o xtrace $ Turn on debug mode 



i 

Main Routine 



| Test for any passed paramaters. 

fif [ $? != 0 ] 
Ithen 

I show_usage 
fffi 

log_dir=$defaulLlog_dir 

§ Parse Command Line Arguments into Variables 

while getopts ol:r# c 

do 

case $c in 

0) § Set up the -o flag 
o_flag=1;; 

1) § Set up the -I flag JP TQ 1 1 T) 

Lflag=1 1 1 ^* 1 1 ^ 

log_dir=$OPTARG;; 
r) § Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_usage;; 
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done 

shift $((0PTIND-1)) 

§ Deal with invocation errors 
if [[ $user_id != root ]]; then 
show_usage 

fi 

if [[ $o_flag -ne 1 ]]; then 

show_usage r ILr. I I ±L 

fi 



§ Configure Logging 

if [[ $Lflag -eq 1 ]]; then 

lo^file=$inJog_dir/$defaulUog_file 

mkdir -p $inJog_dir 2>/dev/null #Create new log directory 

else 

log_file=$defaulLlog_dir/$defaulLlog_file 

mkdir -p $defaulUog_dir 2>/dev/null # Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 
retain_days=$in_retain_days 

fi 

| Clear old logs 

find $log_dir -name "$scripLname*" -mtime $retain_days -exec rm}}\; 
§ Create new log file 

exec 3» Slog file § Open log file for writing 

print -u3 "\n======================================== 

print -u3 M = =" 

print -u3 "= Systems Management Transaction Log =" 

print -u3 "= =" 

print -u3 "= Created by script:" $scripLname 

print -u3 M = on system:" $(hostname) 

print -u3 "= at :"$(date) 

print -u3 "= =" 

print -u3 "========================================= 

# Perform Work 

# Test for existing table file 

if [[ ! (-r $config_file) ]]; then 

print -u2 "Fatal Table error. Table file" $config_file "not found" 
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print -u3 "Fatal Table error. Table file" $config_file "not found.' 
exec 3<&- 
exit 99 



§ Test for existing table audit file 
if [[ ! (-r $audOle) ]]; then 

print -u2 "Fatal Table error. Table file check program must be run" 

print -u3 "Fatal Table error. Table audit file" $audiLfile "not found." 

exec 3<&- 

exit 97 



§ Test for table file audit indicating syntax check since last edit 



currenLY=$(date +%Y) 

audiLstamp=$( head -1 $audiLfile | awk '{ print $1 }') 

§ Check for colon and thus time instead of year on file datestamp 
ntest=$(ls -I $config_file | awk'j print $8 (' | grep : | wc -I) 
if [[ fntest -eq 1 ]]; then 
ediLyear=$currenLY 

else 

ediLyear=$(ls -I $config_file | awk'j print $8 }') 

fi 



edit_month_text=$(ls -I $config_file | awk '{ print $6 (') 
ediLday=$(ls -I $config_file | awk '{ print $7 j') 
ediLhour=$(ls -I $config_file | awk '{ print $8 }' | cut -f 1 -d :) 
edit_minute=$(ls -I $config_file | awk '| print $8 }' | cut -f 2 -d :) 

§ Determine month number from month name 

case $ediLmonth_text in 

Jan) ediLmonth=01;; 

Feb) ediLmonth=02;; 

Mar) ediLmonth=03;; JPTC* 1 1 W 

Apr) ediLmonth=04;; r ILr. I I r 

May) ediLmonth=05;; 

Jun) ediLmonth=06;; 

Jul) ediLmonth=07;; 

Aug) ediLmonth=08;; 

Sep) ediLmonth=09;; 

Oct) ediLmonth=10;; 

Nov) ediLmonth=11;; 

Dec) ediLmonth=12;; 
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*) print -u2 "Fatal Table error. Table file date read error." 
print -u3 "Fatal Table error. Table file date read error." 
exec 3<&- 
exit 98;; 

esac 



ediLstamp=$ediLyear$ediLmonth$ediLday$ediLhour$ediLminute 

§ Test for table file audited since last editing 
if [[ $audiLstamp -le $ediLstamp ]]; then 

print -u2 "Fatal Table error. Table file edited since last checked" 

print -u3 "Fatal Table error. Table file edited since last checked." 

exec 3<&- 

exit 97 

fi 

| Test for locked table file and exit 
if [[ -f llockJile ]]; then 

print -u2 "Table file is currently in use and locked" 

print -u3 "Table file is currently in use and locked" 

exec 3<&- 

exit 96 

fi 

§ Table file format 

| Format: bc:pfs:plv:c:afs:alv = 
| xb:/home:hd1:2:/alt/home:/altlvh 

| Create lock on table file to indicate that table is in use. 
touch $lock_file 
chmod 000 $config_file 

§ Increment through table file and split mirrored filesystems 

return_code=0 

ncrement=0 

for fsjine in $(cat $config_file | grep -v -|) 
do 

action=$(print $fs_line | cut -f 1 -d :) 
copies=$(print $fs_line | cut -f 4 -d :) 
if [[ (fcopies -gt 1) && (taction != no) ]]; then 

fs_prime=$(print $fs_line | cut -f 2 -d :) 

lv_prime=$(print $fsjine | cut -f 3 -d :) 

fs_alt=$(print $fs_line | cut -f 5 -d :) 

lv_alt=$(print $fs_line cut -f 6 -d :) 

tag_file=$fs_prime/.fscpbk_$lv_prime 

exec 4> $tag_file § Open tag file for overwriting 



FIG. 11 G 
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print -u4 "#=====================================:==== 

print -u4 n §= 

print -u4 "#= Tag file used by IBM FSCPBK Utility, 
print -u4 M |= DO NOT DELETE THIS FILE!!!!!!!!!!!!!!! 
print -u4 "#= 

print -u4 "#= Files in this directory and subdirectories below 

print -u4 "#= were originally contained within filesystem: =" 

print -u4 "#= " $fs_prime 

print -u4 "§= = 

print -u4 "|========================================= 

exec 4<&- 

((new„copies=$copies- 1 )) 
sync;sync 

spliLfs_copy.ksh -f $fs_prime -n $fs_alt -y $lv_alt -c $new_copies -o 
((return_code=$return_code+$?)) 

print -u3 $action $fs_prime $lv_prime $copies $fs_alt $lv_alt 

fi 

done 



exec 3<&- 

if [[ ($return_code -ne 0) ]];then 
exit 10 

else 
exit 0 

fi 



FIG. 11 H 
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i§m§§§§§§§§§i§§§§§§§§§MM§§§§§§§§§i§l§§§§§§§§§§§§§§§§§§§§§#§§§§§§§§ 

# fscpb_back.ksh 

I Version 0.34 

# Runs various AIX commands to backup and merge 

# filesystems 

I Assembled by Carl Gusler 
I IBM Global Services 

I IBM Austin 

| cgusler@us.ibm.com 

# 

§ (With help from many friends) 

i Copyright IBM 1996,1997, 1998, 1999 
Controlled Distribution 
Protected under the procedures, processes, rights 
rules, regulations, and retributions of 
IBM Global Services 
Intellectual Capital Management 

i 
i 

§§§§§§i§§§§m§m§§§§§§§§#§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§§ 
i 

i Copyright Information: Copyright IBM 1998 
Controlled Distribution 
Protected under the procedures, processes, rights 
rules, and regulations of 
IBM Global Services 
Intellectual Property Management 

!This program is an IBM Type II Deliverable as 
described in the IBM Customer Agreement and 
relevant IBM services contracts. 



IBM retains all rights to this program and does not 
transfer any rights for replication or distribution 
of this program except for the following: 

1. Backup/archive copies taken as a normal 
course of system maintenance. 

2. Copying the program to a similar machine 
within the same enterprise. 

The customer agrees to restrict access to this 
program as they would their own proprietary code, 
and to notify IBM should unauthorized distribution 
occur. 



FIG. 1 
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§ This program is distributed on an "as is" basis, 

|f no warranty is expressed or implied. 

I 

| 

| 

I 

| Description: Provides capability to perform split mirror backups. 

| Part of FSCPBK package. 

| Operational Environment: AIX V4 and ADSM V3.1 

# Input: 
jjf Output: 
jjf Return Value: 
I Comments: 

i 
i 

i 

i 

i 

| Version History: None 

i 

i 

i 

i 

| Environmental Variables 

i 

i 

| Constants 

bar='=================== 

wire='= 

# Variables 

numeric_date=$(date +%m%d%y) 
texLdate=$(date +%d%b%Y) 
typeset -i return_code 
typeset -i merge_return_code 
typeset -i retain_days=90 
typeset -i in_retain_days 
typeset -i copies 
typeset -i ncrement 
typeset -i mount_fs_Jest 
invokecLname=$0 
scripLname=${invoked_name#jjf*/i 
user_id=$(whoami) 
desc='ADSM Archive at '$texLdate 
level=0 
use_tape=0 



FIG. 1 2B 
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f Process Control Variables 

l_flag=0 

L_flag=0 

tfS3 FIG. 12C 

§ Files 

defaulUog_dir=/var/adm/scriptlogs 

defaulLlog_file=$scripLname.$texLdate 

defaulLbackup_device=/dev/rmt0.1 

worlefile1=/tmp/$scripLname.$texLdate.work1 

wortefile2=/tmp/$scripLname.$texLdate.work2 

conf ig f ile= / etc/ f scpbktab 

audiLfile=/etc/fscpbktab.audit 
loclefile=/var/locks/fscpbktab 



§ Function: show_usage 

§ Description: Displays command usage syntax and exits 
§ Input: None 

# Output: Usage message to standard error 
jjf Return Value: 2 

§ Note: This function does not return. It completely exits. 



show_usage () 

i 

print -u2 

print -u2 "Usage: fscpbk_ack.ksh [-d device] [-I directory] [-r daysf 

print -u2 

print -u2 " -d device Backup output device." 

print -u2 " Default is" $defaulLbackup_device 

print -u2 

print -u2 9 -I directory Log output directory" 

print -u2 " Default is" $defaulLlog_dir 

print -u2 

print -u2 " -r days Log retention period." 

print -u2 " Default is" $retain_days 

print -u2 
exit 2 
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FJG 12[) 

Korn Shell Settings 



|set -o errexit # Turn on error trapping and error exit mode 

Iset -o noclobber § Prevent overwriting of existing files 

Iset -o noexec § Perform syntax checking without execution 

Iset -o nolog § Prevents storing function defs in history file 

|set -o xtrace # Turn on debug mode 

i 

# Main Routine 



I Test for any passed parameters. 

lif [ $? != 0 ] 

Ithen 

| show_usage 
|fi 

I , 

log_dir=$defaulLlog_dir 

| Parse Command Line Arguments into Variables 

while getopts d:l:r# c 

do 

case $c in 

d) f Set up the -d flag 
<Lflag=1 

in_backup_device=$OPTARG;; 
1) § Set up the -I flag 
Lflag=1 

log_dir=$OPTARG;; 
r) § Set up the -r flag 
r_flag=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_usage;; 
esac 
done 

shift $((0PTIND-1)) 

| Deal with invocation errors 
if [[ $user_id ! = root ]] then 
show_usage 

fi 

§ Locate target file or device for backup images 
if [[ IdJIag -eq 1 ]]; then 
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if [[ $in_backup_device = /dev/rmt[0-9]* ]]; then § Test if target is tape drive 
use tape=1 

if [[ -c tin backup device ]]; then # Test if tape drive exists 
device=$in_backup_device 

else 

print -u2 "\nNonexistent tape drive" $in_backup_device 
show-Usage 

fi 

else § Should we check to make sure some disk device not chosen? 
device=$ in_backup_device 

fi 

else 

device=$defaulLbackup_device 

fi 



§ Configure Logging 

if [[ $l - flag -eq 1 ]]; then 

log_file=$inJog_dir/$defaulUog_file 

mkdir -p $in_log_dir 2>/dev/null #Create new log directory 

else 

log_file=$defaulLlog_dir/$defaulLlog_file 

mkdir -p $defaulUog_dir 2>/dev/null § Create default log directory 

fi 

if [[ $r_flag -eq 1 ]]; then 

retain_days=$in_retain_days 

fi 

| Clear old logs 

find $log_dir -name "$scripLname*" -mtime $retain_days -exec rm ||\; 
| Create new log file 

exec 3» Slog file # Open log file for writing 

print -u3 w \n============================-============ 

print -u3 "= = w 

print -u3 "= Systems Management Transaction Log =" 

print -u3 "= =" 

print -u3 "= Created by script:" $scripLname 

print -u3 "= on system:" $(hostname) 

print -u3 "= at :" $(date) 

print -u3 "= =" 

print -u3 "=========================================== 
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§ Perform Work 

§ Test for existing table file 
if [[ ! (-r $config_file) ]]; then 

print -u2 "Fatal Table error. 

print -u3 "Fatal Table error. 

exec 3<&- 

exit 99 

fi 

§ Test for existing table audit file 
if [[! (-r laudiUile) ]]; then 

print -u2 "Fatal Table error. Table file check program must be run" 

print -u3 "Fatal Table error. Table audit file" $audiLfile "not found." 

exec 3<&- 

exit 97 

fi 

§ Test for table file audit indicating syntax check since last edit 



currenLY=$(date +%Y) 

audiLstamp=$( head -1 $audiLfile | awk '{ print $1 j') 

§ Check for colon and thus time instead of year on file datestamp 
ntest=$(ls -I $config_file | awk '\ print $8 }' | grep : | wc -I) 
if [[ $ntest -eq 1 ]]; then 
ediLyear=$currenLY 

else 

ediLyear=$(ls -I $config_file | awk '{ print $8 }') 

fi 



ediLmonth_text=$(ls -I $config_file | awk '{ print $6 }') 
ediLday=$(ls -I $config_file | awk '{ print $7 }') 
ediLhour=$(ls -I $config_file | awk '| print $8 }' | cut -f 1 -d :) 
ediLminute=$(ls -I $config_file | awk i print $8 j' | cut -f 2 -d :) 

# Determine month number from month name 
case $edit_montk_text in 
Jan) ediLmonth=01;; 
Feb) ediLmonth=02;; 
Mar) ediLmonth=03;; 
Apr) ediLmonth=04;; 
May) ediLmonth=05;; 
Jun) ediLmonth=06;; 
Jul) ediLmonth=07;; 



Table file" $config_file "not found." 
Table file" $config_file "not found" 



FIG. 12F 
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Aug) ediLmonth=08;; 4ZD1 

Sep) ediLmonth=09;; FIG. 1 2G 

Oct) ediLmonth=10;; 
Nov) ediLmonth=11;; 
Dec) ediLmonth=12;; 

*) print -u2 "Fatal Table error. Table file date read error" 
print -u3 "Fatal Table error. Table file date read error." 
exec 3<&- 
exit 98;; 

esac 



ediLstamp=$ediLyear$ediLmonth$ediLday$ediLhour$ediLminute 

# Test for table file audited since last editing 
if [[ $audit_stamp -le $ediLstamp ]]; then 

print -u2 "Fatal Table error. Table file edited since last checked" 

print -u3 "Fatal Table error. Table file edited since last checked" 

exec 3<&- 

exit 97 



§ Table file format 

§ Format: bc:pfs:plv:c:afs;alv 

# xb:/home:hd1 :2:/alt/home:/altlvh 



ncrement=0 
return_code=0 

| Cycle through filesystems and mount unmounted ones 

for fsjine in $(cat $config_file | grep -v 

do 

action=$(print $fs_line | cut -f 1 -d :) 
fs_prime=$(print $fs_line cut -f 2 -d :) 
lv_prime=$(print $fs_line cut -f 3 -d :) 
copies=$(print ffsjine | cut -f 4 -d :) 
targeLfs=$fs_prime 
if [[ taction != no ]]; then 
if [[ $copies -gt 1 ]]; then 

target_fs= $(print $fs_line I cut -f 5 -d :) 

fi 



09/439,054 

43/51 FIG 1 2H 

§ Check to see if target filesystem is mounted 

mounLfs_test=$(mount | grep "ftargeLfs | wc -I) 
§ If not mounted, mount as readonly for backups 
if [[ $mounLfs„test -ne 1 ]]; then 

mount -o ro ftargeLfs »$log_file 2>>$log_file 
return_code=$? 
# Test for unsuccessful readonly filesystem mount 

if [[ $return_code -ne 0 ]]; then 
§ If still unsuccessful, then perform filesystem check (presume dirty superblock) 
print -u3 "Performing fsck on filesystem" ftargeLfs 
fsck -p StargeLfs »$log_file 2»$logfile 
mount -o ro ftargeLfs 2»$log_file 



fi 



fi 

fi 



done 

return_code=0 
merge_return_code=0 

§ Put Table File at start of tape to serve as tape TOC 
if [[ $use_tape -eq 1 ]]; then 
cp /etc/fscpbktab . 

echo w ./fscpbktab tt | backup -ipqf fdevice 
rm ./fscpbktab 

fi 

# Cycle through filesystems and perform backups and merges 

for fsjine in $(cat $config_file | grep -v 

do 

action=$(print $fs_line | cut -f 1 -d :) 
fs_prime=$(print $fs_line | cut -f 2 -d :) 
lv_prime=$(print $fs_line | cut -f 3 -d :) 
copies=$(print $fs_line | cut -f 4 -d :) 
targeLfs=$fs_prime 

print -u3 faction $fs_prime $lv_prime $copies 
if [[ faction != no ]]; then 
§ Select to backup alternate mirror fs if mirroring on 
if [[ $copies -gt 1 ]]; then 

fs_alt=$(print $fs_line cut -f 5 -d :) 
lv_alt=$(print $fs_line cut -f 6 -d :) 
targeLfs=$fs_alt 

print -u3 faction $fs_prime flv^prime fcopies $fs_alt $lv_alt 

fi 
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mount_fs_test=$(mount | grep "ItargeLfs" | wc -I) 
Test for filesystem STILL not mounted 
if [[ $mounLfs_test -eq 1 ]]; then 



case taction in 



no) § Perform no backup action 

print -u3 "No backup performed on filesystem" $targeLfs;; 
xb) § Perform AIX Level 0 filesystem backup 

print -u3 "Starting AIX Level 0 backup on filesystem" $targeLfs "at" $(date) 

backup -|level -u -f $device $targeLfs 

return_code=|return_code+|? 

print -u3 "Completed AIX Level 0 backup on filesystem" $target_fs "at" $(date);; 
as) # Perform AOSM Selective filesystem backup 

print -u3 "Starting ADSM Selective backup on filesystem" ItargeLfs "at" $(date) 
dsmc sel "ItargeLfs/*" >|work_file1 
retun\_code=|returrucode+|? 
cat |work_file1 »$log_file 

print -u3 "\n " 

print -u3 "Completed ADSM Selective backup on filesystem" $targeLfs "at" $(date);; 
ai) § Perform ADSM Incremental filesystem backup 

print -u3 "Starting ADSM Incremental backup on filesystem" $targeLfs "at" $(date) 
dsmc i $targeLfs >|work_file1 
return_code=$return code+|? 
cat $work_file1 »|log_file 

print -u3 "\n " 

print -u3 "Completed ADSM Incremental backup on filesystem" $targeLfs_prime "at" 



aa) § Perform ADSM Archive filesystem archive 

print -u3 "Starting ADSM Archive on filesystem" ItargeLfs "at" |(date) 
dsmc archive ItargeLfs/ -des="|desc" >|work_file1 
return_code-|return_code+|? 
cat |work_file1 >>$log file 

print -u3 "\n " 

print -u3 "Completed ADSM Archive on filesystem" ItargeLfs "at" |(date);; 

esac 

| Merge split filesystems if mirrored 
jjf NOTE!!: This section is duplicated in the fscpblemerge.ksh 
§ script. Any changes anywhere in this script should 

jjf probably be duplicated in that script! 



I(date);; 



if [[ Icopies -gt 1 ]]; then 



§ 
§ 

§ 



merge.Js_copy.ksh -p |fs_prime -s |fs_alt 
merge_return_code=|merge_return_code+|? 
fs_alt=|(print Ifsjine | cut -f 5 -d :) 
lv_alt=|(print Ifsjine | cut -f 6 -d :) 
targeLfs=|fs_alt 



FIG. 121 
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§ fscpb_merge.ksh 

I Version 0.01 

§ Runs various AIX commands to merge 

| filesystems 

I Assembled by Carl Gusler 

I IBM Global Services 

I IBM Austin 

| cgusler@us.ibm.com 

# 

jjf (With help from many friends) 

§ 

jjf Copyright IBM 1996, 1997, 1998, 1999 

| Controlled Distribution 

# Protected under the procedures, processes, rights 

jjf rules, regulations, and retributions of 

| IBM Global Services 

| Intellectual Capital Management 



# 

# 

§ Copyright Information: Copyright IBM 1998 

jjf Controlled Distribution 

| Protected under the procedures, processes, rights 

jjf rules, and regulations of 

# IBM Global Services 

jjf Intellectual Property Management 

# 

jjf This program is an IBM Type II Deliverable as 

| described in the IBM Customer Agreement and 

jjf relevant IBM services contracts. 

i 

jjf IBM retains all rights to this program and does not 

| transfer any rights for replication or distribution 

| of this program except for the following: 

| 1. Backup/archive copies taken as a normal 

| course of system maintenance. 

| 2. Copying the program to a similar machine 

jjf within the same enterprise. 

i 

jjf The customer agrees to restrict access to this 

| program as they would their own proprietary code, 

jjf and to notify IBM should unauthorized distribution J* 1 J £ # / 3 A 

§ occur. 
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This program is distributed on an "as is" basis, 
no warranty is expressed or implied. 



Description: Remerges filesystems split from mirrored LVs. 

A cleanup utility for problem times with FSCPBK scripts 
Operational Environment: AIX V4 
Input: 
Output: 
Return Value: 

Comments: NOTE!!: This script is an excerpt of the fscpbleback.ksh 
script. If that script is edited, this one 
should probably be edited to match. 




§ Variables 

numeric_date=$(date +%m 
texLdate=$(date +%d%b 

typeset -i return_code %d%y) rpm -i O TD 

typeset -i merge_return_^pjzte r ILr. 1 Ojlj 

typeset -i retain_days=90° 

typeset -i in_retain_days 

typeset -i copies 

typeset -i ncrement 

typeset -i mounLfs_test 

invoked_name=$0 

scripLname=$ |invoked_name##*/ 

user_id=$(whoami) 

desc='ADSM Archive at'$texLdate 

level=0 I 
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§ Process Control Variables 47/51 

l_flag=0 

L_flag=0 

r_flag=0 

Oag=0 JPJQ / 3 Q 

§ Files 

defaulUog_dir=/var/adm/scriptlogs 
defaulLlog_file=$scripLname.$texLdate 
defaults backup_device=/ dev/ rmtO. 1 
work_file1=/tmp/$scripLname.$texLdate.work1 
work_file2=/tmp/$scripLname.$texLdate.work2 

conf ig f ile= / etc / f scpbktab 

audit_file=/etc/ fscpbktab.audit 
lock_file=/var/locks/fscpbktab 

i 

# 

§ Function: show_usage 

| Description: Displays command usage syntax and exits 

| Input: None 

| Output: Usage message to standard error 

| Return Value: 2 

| Note: This function does not return. It completely exits. 



show_usage () 

\ 

print -u2 " 

print -u2 "Usage: fscpbk_merge.ksh [-I directory] [-r days] 1 

print -u2 n 

print -u2 " -I directory Log output directory" 

print -u2 " Default is" $defaulLlog_dir 

print -u2 " 

print -u2 " -r days Log retention period." 

print -u2 " Default is" $retain_days 

print -u2 " 
exit 2 



§ Korn Shell Settings 

i 

i 

#set -o errexit # Turn on error trapping and error exit mode 
#set -o noclobber # Prevent overwriting of existing files 
fset -o noexec § Perform syntax checking without execution 
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fset -o nolog § Prevents storing function defs in history file 
#set -o xtrace § Turn on debug mode 

| 

I 

jjf Main Routine 

# 

i 

i 

§ Test for any passed paramaters. 

#if [ $? != 0 ] 

jftthen 

§ show_usage 

ffi 

# 

log_dir=$defaulUog_dir 

| Parse Command Line Arguments into Variables 

while getopts l:r# c 

do 

case $c in 

I) # Set up the -I flag 
Lflag=1 

log_dir=$OPTARG;; 
r) | Set up the -r flag 
r_flog=1 

in_retain_days=$OPTARG;; 
:) show_usage;; 
\?) show_usage;; 
esac 

done 

shift $((0PTIND-1)) 

§ Deal with invocation errors 
if [[ $user_Jd != root ]]; then 
show_usage fi 

fi 

# Configure Logging 

if [[ $Lflag -eq 1 ]]; then 

log_file=$irUog_dir/$defaulUog_file 

mkdir -p $inJog_dir 2>/dev/null |Create new log directory 

else 

log_file=$default_log_dir/$default_log_file 

mkdir -p $defaulLlog_dir 2>/dev/null § Create default log directory 

fi 

if [[ tr.flag -eq 1 ]]; then 

retain_days=$in_retairudays r lLr. 

fi 
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§ Clear old logs 4W:>1 

find $log_dir -name "fscripLname*" -mtime $retain_days -exec rm 



§ Create new log file 

exec 3» $log_file § Open log file for writing 



print 


-u3 "\n 




print 


-u3 "= 


» 


print 


-u3"= 


Systems Management Transaction Log 


print 


-u3"= 




print 


-u3 "= 


Created by script" $scripLname 


print 


-u3 " = 


on system:" $(hostname) 


print 


-u3" = 


at :" $(date) 


print 


-u3 " = 




print 







§ Perform Work 

| Comments: NOTE!!: This script is an excerpt of the fscpbk_back.ksh 

| script. If that script is edited, this one 

| should probably be edited to match. 

* 

jjf Test for existing table file 
if [[ ! (-r $config_file) ]]; then 

print -u2 "Fatal Table error. Table file" $config_file "not found." 

print -u3 "Fatal Table error. Table file" $config_file "not found." 

exec 3<&- 

exit 99 

fi 

| Test for existing table audit file 
if [[ ! (-r $audiUile) ]]; then 

print -u2 "Fatal Table error. Table file check program must be run" 

print -u3 "Fatal Table error. Table audit file" $audit_file "not found." 

exec 3<&- 

exit 97 

fi 

# Test for table file audit indicating syntax check since last edit 
currenLY=$(date +%Y) 

audiLstamp=$( head -1 faudiLfile | awk'j print $1 }') 

# Check for colon and thus time instead of year on file datestamp 
ntest=$(ls -I $config_file | awk'j print $8 }' | grep : | wc -I) 

if [[ tntest -eq 1 ]]; then FIG. 1 

ediLyear=$currenLY 
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else 50/51 
ediLyear=$(ls -I $config_file | awk *{ print $8 j') FIG. 1 3F 

fi 



ediLmonth_text=$(ls -I Iconfigjile | awk 'j print $6 {') 
ediLday=$(ls -I $config_file | awk 'j print $7 }' 
ediLhour=$(ls -I $config_file | awk 'j print $8 j' | cut -f 1 -d :) 
ediLminute=$(ls -I $config_file | awk 'j print $8 j' | cut -f 2 -d :) 

# Determine month number from month name 

case $ediLmonth_text in 

Jan) ediLmonth=01;; 

Feb) ediLmonth=02;; 

Mar) ediLmonth=03;; 

Apr) ediLmonth=04;; 

May) ediLmonth=05;; 

Jun) ediLmonth=06;; 

Jul) ediLmonth=07;; 

Aug) ediLmonth=08;; 

Sep) ediLmonth=09;; 

Oct) ediLmonth=10;; 

Nov) ediLmonth=11;; 

Dec) edit_month=12;; 

*) print -u2 "Fatal Table error. Table file date read error." 
print -u3 "Fatal Table error. Table file date read error." 
exec 3<&- 
exit 98;; 

esac 



ediLstamp=$ediLyear$ediLmonth$ediLday$ediLhour$ediLminute 

§ Test for table file audited since last editing 
if [[ $audiLstamp -le $edit_stamp ]]; then 

print -u2 "Fatal Table error. Table file edited since last checked" 

print -u3 "Fatal Table error. Table file edited since last checked" 

exec 3<&- 

exit 97 



§ Table file format 

# Format: bc:pfs:plv:c:afs:alv 

# xb:/home:hd1 :2:/alt/home:/altlvh 
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ncrement=0 

return_code=0 

merge_return_code=0 

§ Cycle through filesystems and perform merges 
for fsjine in $(cat $config_file | grep -v -#) 
do 

action=$(print $fs_line | cut -f 1 -d :) 
fs_prime=$(print $fs_line | cut -f 2 -d :) 
lv_prime=$(print $fs_line | cut -f 3 -d :) 
fs_alt=$(print $fs_line | cut -f 5 -d :) 
lv_alt=$(print $fs_line | cut -f 6 -d :) 
copies=$(print $fs_line | cut -f 4 -d :) 
targeLfs=$fs_prime 

print -u3 taction $fs_prime $lv_prime Icopies 
if [[ taction != no ]]; then 

# Merge split filesystems if mirrored 
if [[ $copies -gt 1 ]]; then 

merge_fs_copy.ksh -p $fs_prime -s $fs_alt 
merge„return_code=$merge_return_code+$? 

fi 

fi 

done 



exec 3<&- 

§ Test for unsuccessful filesystem merges 
if [[ $merge_return_code -ne 0 ]]; then 
exit 20 

fi 

| Remove lock on table file 
rm $lockJile 2>/dev/null 
chmod 644 $config_file 

exit 0 
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